"PRELIMINARY" 064 TEST PAM.SL 


HARDWARE 

The Q64 Test Panel is a modified VT3 logic card. It must be installed in 
a VT3 monitor to be operational. The modifications required will result 
in the logic card remaining dedicated to this purpose ( the mods are 
permanent). The board v^ill be shipped with mods in place. There are no 
current plans for modifications to be done in the field. 


INSTALLATION 


Once the logic card is in place, the Q64TP is cabled directly to the AUXe 
CPU card through the "top" serial port. The port belov7 is for indirect 
access and is not currently being used, 

TEST PANEL USE 

Upon pov/er-up, the the Q64TP will come up v;ith the a display similar to 
Fig. 1. The processor is manipulated and interigated by the use of the 
commands listed in sections 4.0 thru 5,0, Commands are entered in the 
lov/er left corner. Note: some commands have not yet been implemented. 

ALWAYS begin by entering HALT. The Q64TP can not execute commands if the 
CPU is already busy. Once halted commands may be entered by exact spelling 
or abbreviations. Typing HELP v/ill get you a list of the acceptable abbre- 
viations, 

DISCLAIMER: This document is intended ONLY as an introduction to the Q64TP. 
The panel is still under development. The functions described here are 
subject to change, A final release document will accompany the final 
product. 



1.0 “ INTROnnCTTOM 


This document describes the Q64 Test Panel (C64TP) for the Q64. 

The design goals of the C64 Test Panel are: 

. Provide a method to debug assembly language programs 
running on the Q64 processor; 

. Provide most of the features available on the Q29BS Test 
Panel for the Q64; 

. Provide some diagnostic capabilities to the programmer or 
field service person when the Q64 does not operate 
correctly; 

. Provide some "logic analyzer" features, such as tracing, 
counting, and histograms. 

Whenever possible, the commands and features of DELTA, Qantel ' s 
Debugging Monitor, will be included. Ideas are also ^-ncorporatea 
from the Q29BS Test Panel, the Q64 Micro Monitor, and DFULL32. 

The Q64 Test Panel does not attempt to replace DELTA. It is 
oesigned to be used when DELTA is not sufficient, such as 
debugging the Operating System, I/O drivers, standalone 
programs, or ATPs. 

It will only run with the Q64. 

Using the Test Panel will impose extra processing on the Q64 
microcode. This will be minimized as much as possible; however, 
it will slow the Q64 and change the timing of the macro execution. 
No time penalty is imposed when the Test Panel is idle. 





■2.0- C OMPONENTS OF THE 064 TEST PANEL 


The 064 Test Panel consists of a VT3 with specially-programmed 
ROMs. It will be connected via a^ stanoard RS232 cable to che 
serial port on the Q64 processor. 

The Q64 supports the Test Panel with: 

1) Serial port for transmitting and receiving asynchronous 
data at 19,200 bps; 

2) Single Step hardware mode, which allows the processor 
to stop between macro instructions; 

3) C04 firmware which handles commands sent to it via 
the serial port. 


2.1 TEST PANEL LIMITATIONS 

A discussion of Test Panel limitations will be made here because 
they result from the lack of hardware in the system. Features, 
such as stopping the machine whenever an address is accessed, 
cannot be implementd because there is no haraware "KASP" function. 
The panel is also not capable of debugging or tracing the Q64 
microcode, due to the nature of the hardware. 

Advanced DELTA features, such as using the symbolic debugging, 
are not available because the Test Panel has no way of accessing 
the symbol table (nor the RAM space to keep it) . Dis-assembly 
of REAL statements is also not feasible aue to lack of ROM space. 
The Test Panel cannot generate harocopy output because it has no 
access to a printer. Its only interfaces are th Q64 microcode, 
the display screen, ano the keyboard. 

The VT3 was selected over the VT4 for its availability. At a 
later time, the VT4 can be considered. 


I 
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3 .0 • GE NERAL DESCRI PTIQl^ 


The Q64 Test Panel consists of’ a video display screen and a 
keyboard. The current state of the C64 processor is indicated 
on the display screen. The operator communicates with the 
Q64TP by typing commands on the keyboard. These commands may 
be processed internally by the Q64TP or may result in messages 
being sent to the Q64. The results of all commands are displayed 
on the screen. 


3.1 DISPLAY SCfiEEN 

The display screen consists of 25 lines containing 80 characters 
each. The screen will be logically divided into two sections: 
fixed display area and operator area. 

Lines 1 through 17 are the fixed display area which will display 
the current state of the Q64. This induces the macro code 
program counter (PC) , the current macro instruction, the con- 
dition flags, the base registers, and the user breakpoints. All 
values are dipslayeo in hexadecimal, except the flags which 
will be symbolic (NZ, MI, OV) . 

Lines 18 through 25 are used for operator input and responses 
from the Q64TP. This section of the screen is treated as a type- 
writer and will roll up with each new line. The Q64TP displays 
the prompt on line 25, column 1, when it is awaiting operator 
input. Keys typed by the operator will be entered on line 25. 

A blinking cursor will indicate the next location for operator 
entry. 

The display screen is formacteu ^..cwn on the nex^ 
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£ISIIE£-.I 


(1) 

BREAKPOINTS 

Q64 TEST PANEL 

(2) BASE REGISTERS 


1 AT aaaa 


BR0 

aaaaaa 


2 IF aaaa rel bb 


BRl 

bbbbbb 


3 AT aaaa IF bbbb rel 

cc 

BR2 

cccccc 




BR3 

dddddd 




BR4 

eeeeee 




BR5 

ffffff 




BR6 

gggggg 




BR7 

hhhhhh 

(3) 

0-7: xxxxxxxxxxxxxxxx 


BR8 

mill 


8-F; xxxxxxxxxxxxxxxx 


BR9 

333333 




BRA 

kkkkkk 




BRB 

mill 

(4) 

HALT/RUN 


BRC 

mmmmmm 

(5) 

FLAGS NZ, MI, OV etc. 


BRD 

nnnnnn 

(6) 

QPC aaaa: cccccccccccccccc 

BRE 

oooooo 


pppppp 


BRF 

rrrrrr 


: Operator enters data 

here 




FIELDS DEFIIJSD 

(1) BREAKPOINTS, debugging aids for determining proper program flov7e 
Will cause the processor to halt if the criteria is met. See 
section 5.0 for determining criteria variables. 

(2) BASE REGISTERS, this is a display of the contents of the 16 registers. 

(3) ACCUMULATER CONTENTS, scratch pad in memory. 

(4) HALT/RUN, V7ill display either HALT or RUNNING. 

(5) FLAGS, V7ill shov7 v/hat processor flags are set. 

(6) QAI^TEL PROGRAM COUNTER: aaaa= current "logical" memory address. 

cccccccccccccccc= current macro instruction 

from the FETCHER 

pppppp= current "physical" memory address 




3.2' OPERATOR KEYBOARD. EIITRY 

The user communicates to the Q64TP by typing commands on the 
keyboara. As each character is typed, it is displayed at the 
cursor position on line 25; The cursor is incrementeo to the 
next location. At the end of line 25, the Keys will overstrike, 
causing the audible alarm. The command is terminated by entering 
RETURN, TAB, or TRANSMIT. 

The control Keys available on the VT3 will be implemented. These 
are listed in the table below. All keys will repeat at approx- 
imately 10 cps after being depressed for 1 second. 


3.2.1 KEYBOARD CONTROT. FCEYS 


BACKSPACE Moves cursor right one location. 

SHI FT/ BACKS PACE Moves cursor left one location. 


CLEAR Clears line 25 to blanks. 

SHIFT/CLEAR Clears line 25 from cursor to end of line. 


INS CHAR 

SHI FT/ INS CHAR 


Inserts blank character at cursor position and 
shifts all characters to the end of the line one 
position right. The last character is lost. 
Deletes character at cursor position and shifts 
all characters to the right of the cursor one to 
the left. A blank is inserted at the end of 
the field. 


LTRS 


I RETURN 
I SHI FT/ RETURN 
I TAB 

I SHIFT/TAB 

I TRANSMIT 
i SHIFT/TRANSHIT 

I F2 

I F3 


Allows upper ana lower case alphabetic characters 
to be entered. When pressed a secona time, it 
restores upper case mode. 

Terminates aata entry. Indicates that command 
is ready to be executed by the Test Panel. 
Positions cursor to beginning of line 25. 

Same as RETURN. 

Same as SHI FT/ RETURN. 

Same as RETURN. 

Same as SHIFT/RETURN. 

Single step Macros. 

Abort routine. 
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4.0- COMMAND SYNTAX 

• ^ 

The general format of a command to the Q64TP consists of a verb 

followed by zero, one, or more par amete rs . 

The verb indicates what action is to be performed. The parameters 
specify the details of the action, such as what address should 
be displayed or mooified. 

4.1 DATA ITEMS 

The Test Panel recognizes the following data items: 

. Hexadecimal numbers - one or more digits 0-9 or A-F 

e Decimal numbers - one or more digits 0-9 followed by *.* 

. Symbolic names - an alphabetic character followed by 

zero to five alphanumeric characters 

. ASCII strings - zero or more characters enclosed in single 
or double quotes 

is the current Qantel macro program counter 
. *§' is the last address entered by the user (MAR) 


4 .2 ADDRESS EXPRESSIONS 

An address expression is formed by combining one or more 
numbers, symbols, or with the arithmetic operators 

'+', or Expressions are evaluated left to right, 

with no operator precedence. 

Normally the Test- Panel will assume "logical addressing", i.e., 
addresses are 15 bits relative to the current base register 
setting. If the user requires a physical aaoress, the address 
is prefaced with '#'. To access the priviledged memory, preface 
the address with '%'. (Note: all addresses will be maintained 
internally as 24-bit absolute addresses.) 



4 .3 LENGTHS 


A length is a hexaaecimal or decimal number. 

4 e4 SYMBOLS 

The user can define symbol names to reference certain values. 
Some symbols are predefined: 

PC Current Qantel macro program counter 

BRO, BRl , ... BRF The 16 base registers 

MAR Memory Address Register - last address entered by user. 


5.0 COMMANDS 

Any command verb may be abbreviated to the minimum number of 
characters to make it nonambiguous. 

A list of commands is available upon typing 'HELP*. The Test 
Panel will display '?' if it cannot recognize the command. 
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5.1.1 DISPLAY MEMORY 


DISP aaor [,len] [\forinat] 


This command displays the memory contents at a specified address 
with a g-iven length ana format. It sets to the current 
memory address. Addresses are left-hana addresses. 

The length option sets the number of bytes to be displayed. If 
specified, it must be a constant (hex or decimal) . It defaults 
to 16 if not specified. 

The format option can be either *K* for hexadecimal or *A' for 
ASCII. Initially, it will be hexadecimal. Once a format has 
been explicitly set, it remains in effect until changed. 


5.1.2 EXAMTHR HEX EH addr [,len] 

Same as display in hexadecimal format. 

5.1.3 EXAMINE ASCII EA addr (,len] 

Same as display in ASCII format. 


5.1.4 DUMP MEMORY DUMP addr (,len] 

Tne Dump command displays one or more formatted lines containing 
16 bytes of hexadecimal followed by the equivalent ASCII. 


5.1.5 SHOW COMMAND 


SHa'7 item 


The Show coinmand displays information about the Q64 or the 
debugging session. The items available to be shown are: 


SHOW AT - 
SHOW DO - 
SHOi; EQU - 
SHa/ IF - 
SHOvV MICRO 


list breakpoints set by AT command, 
list commands saved by SAVE command, 
list all symbols defined by EQU command, 
list all data breakpoints set by IF command, 
list the contents of the 16 micro registers and 
other information pertaining to Q64 microcode, 
list Status 0 of all 16 I/O controllers. 


/z 


SHOW ST - 



5.2 ‘ SET COMMANDS 

The Set commana group allow the user to modify the Q64's memory 
and other features. 


5.2.1 SET MEMORY SM address, expr 

This command changes the contents of a memory location to the 
expression specified. The expression may be a hexadecimal 
number or an ASCII string. The number of bytes changed is 
inaicated by the expression. 


5.2.2 MODIFY CURRENT MEMORY / expr 

Same as Set Memory, except the aadress is assumed to be 


5.2.3 FILL MEMORY FM addr , len, expr 

This command causes the memory specified to be filled with a 
single character indicated by expr. 


5.2.4 HOVE MEMORY (AJ J ' MOV addrl,len,aodr2 

The Move command moves the data specified at addrl to addr2 for 
the number of bytes in len. 


5.2.5 UPDATE MEMORY UM addr 

The Update command displays 16 hexadecimal bytes of data at the 
address specified in foreground. It waits for the operator to 
change this data as desired. Then, it writes the updated data 
back to the Q64 memory. This is repeated until the operator 
enters an empty line. 



5*2- SET COMMANDS - continued 


5.2.6 EQUATE ' EQU symbol [,addr] 

The Equate command defines a debug- time symbol to the Test Panel. 
This symbol can be used in aoaress calculations. If an address 
is specified, it is used as the symbol's value. If no address 
is specified, '$* is used. 


5.2.7 SET SET item,expr 

The Set command changes the value of certain elements of the 
Q64 machine. 

SET BRn - sets base register n (n=0-F) . 

SET FLAGS sets the condition flags. 1 

SET PC - sets the macro program counter ^ 

SET Rn - sets the micro register n (n=0-F)^A^l ) 



5.3- EXECUTION CONTROL COMMANDS 


These commanas allow the user to control and monitor the Q64's 
execution of macro instructions. 


5.3.1 HALT HALT 

The Halt command causes the Q64 to halt at the next macro 
instruction fetch. The display screen will be formatted with 
the current QPCr FLAGS, base register settings, etc. 


5.3.2 MICRO HALT HALT* 

This command should only be used if the normal HALT does not 
respond. H/JLT* stops the Q64 in the middle of macro instruction 
execution (if possible) and allows the operator to investigate the 
machine state. 


5.3.3 START EXECUTION GO [addr]’ 

The Go cormnand causes the Q64 to start executing macro instructions 
at PC or the address specif iea. 

5.3.4 STEP STEP [addr] 

The Step command causes the Q64 to execute one macro instruction 
at PC or at the address specif iea. 

5.3.5 INITIAL PROGRAM T.QAD . IPL • 

The IPL commana causes the Q64 to branch to location 0 of the ^ 
microcode and act as if IPL was pressed. 



5.4 BKEAKPQ INt con HANDS 


The Breakpoint commands impose a tremendous processing overheao 
on the Q64. Don’t be surprised at the slow machine. 


5.4.1 c;ET TN.qTRTTCTTQN BREAKPOINT AT addr 

This instruction sets an instruction breakpoint at the specified 
address. If the machine is running, it will halt upon executing 
a macro instruction starting at this address. 


5.4.2 SET DATA BREAK POINT IF aodr rel constant 

A oata breakpoint occurs when the address specified has the 
required relation to the constant. For example, when location 
1000 is equal to 20. The length of compare is always 1 byte. 

The relation may be EQ, NE, GT, GE, LT, or LE. 


5.4.3 SET ■CQIJDIT TONAL BREAKPOINT AT addrl IF addr2 rel constant 

The conditional breakpoint sets an instruction breakpoint at addrl. 
When this occurs, it checks the data breakpoint specified. If 
the relation is true, the machine is halted; else, it continues 
execution. 




5.5.1 HELP ' HELP 

The Help command displays all currently available to the user. - 


5.5.2 


SAVE text 


Commands may be saved in an internal table via the SAVE 
command. The Test Panel will display a message of the forms 
' SAVED IN nn ' . 


5.5.3 DQ SAVED COMMAND DO num 

The Do command activates a saved statement. 

« 

5.5.4 EVALUATE EVAL expr 

The Evaluate command causes the expression to be evaluated 
and the result displayed on the screen. 

5.5.4 KILL KILL item 

Tne Kill command causes the Test Panel to remove the specified 
items from its internal tables. 

KILL AT [addr] - discard all instruction and conditional break- 
points or the one whose address is specified. 

KILL DO [num] - discard all saved commands or the one whose 

address is specified. 

KILL EQU - discaro all symbols defined by EQUATE commands. 

KILL IF [addr] - discaro all oata breakpoints or the one whose 

address is specified. 
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5.. 6- FUTURE COMMAMDS 


These commanas will be 

5.6.1 COMPARR MEMORY 

5.6.2 FTND STRTNr, 

5.6.3 ACTIVATE HTSTQC^RAM 

5.6.4 DEACTIVATE HTSTOCRAM 

5.6.5 ACTIVATE COUNTTNC 


LJ 

implemented at a later time 


CHP addrl , len^ ^ddr2 


FIND addr , len, expr 


HIST ON 


HIST OFF 


COUOT ad dr 


aefined and 



